home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / comm / www / Cookie_Killer.readme < prev    next >
Text File  |  2001-05-03  |  10KB  |  239 lines
  1. Short:    AWeb cookie management (v1.21)
  2. Author:   greggsawyer@fcol.com (Gregg Sawyer)
  3. Uploader: greggsawyer@fcol.com (Gregg Sawyer)
  4. Version:  1.21
  5. Type:     comm/www
  6. Replaces: comm/www/Cookie_Killer*
  7. Requires: AWeb-II v3.4, ARexx, Amiga OS3.5 (may work with earlier versions)
  8.  
  9. This set of ARexx programs allows one to manage one's cookie cache, both
  10. interactively and automatically.
  11.  
  12. They take advantage of the fixed cookie functions in AWeb-II v3.4, which is why
  13. they will not work with earlier versions (SETCOOKIES caused AWeb to hang on
  14. exit).
  15.  
  16. These programs are free - free as the birds in the sky, free as the fish in the
  17. sea, free as the wind in your undergarments. Of course, you may send me e-mails,
  18. whether of appreciation or derogation I care not - just send 'em if you want
  19. support and enhancements, or if you think I'm smashing and want to have my
  20. babies.
  21.  
  22.  
  23. Change Highlights for Version 1.21 (Wednesday 07 March 2001):
  24.  
  25.    Minor fix to use consistently AWebPath: (assign dynamically added when AWeb
  26.    starts) rather than AWeb3: (assign which may or may not be set
  27.    by AWeb installation). If you have AWeb3: assigned to the AWeb program
  28.    directory, you would not have witnessed any problems; otherwise, various
  29.    files will have popped up in odd places, and Cookie_Killer functions
  30.    would have been... ahem... unpredictable. Apologies.
  31.  
  32. IMPORTANT NOTE : The current version of VersionWB does not interpret the
  33.    version string in the cookies_keep file correctly, leading to scrambling
  34.    of this file and deletion of all cookies. Please do not use VersionWB as
  35.    a direct replacement for the original "version" command with Cookie_Killer
  36.    (i.e do not rename nor copy "VersionWB" to "version"). Thanks to Jose
  37.    Andias for reporting this.
  38.  
  39.  
  40. Author's Note:
  41.  
  42.    Although I have had little e-mail feedback on Cookie_Killer (but thank you,
  43.    Bill Parker at Amitrix), I note it's continued presence in the Aminet charts,
  44.    so I took that as encouragement to produce this enhancement - thank you for
  45.    your votes! However, further upgrades will require a significant commitment
  46.    of time and effort, and I will need direct feedback to justify this. On the
  47.    other hand, Cookie_Killer may be sufficient as it stands - let's see...
  48.  
  49.    Possible enhancements : Select for "delete" as alternative to "keep"; AWNPipe
  50.    interface to overcome shortcomings of HTML; full documentation, AmigaGuide
  51.    or HTML; installation script; enhanced sort feature; "keep all" and "kill
  52.    all" options; unlimited number of cookie keep selections.
  53.  
  54.  
  55. Installation:
  56.  
  57.    Unpack archive to T: (RAM disk) and open the Cookie_Killer_pkg drawer.
  58.  
  59.    Copy cookie_list_usage.html to [AWeb3 path/]Plugins/ drawer.
  60.  
  61.    Copy Cookie_killer drawer (including contents) to [AWeb3 path/]Plugins/ drawer.
  62.  
  63.    Copy startup.awebrx to anywhere you want - suggest [AWeb3 path/].
  64.  
  65.    Copy this .readme file to anywhere, and forget where so that you won't be
  66.    able to find it in six months time when you want to know what this dang thang
  67.    does again... Whatever you do, don't actually _read_ it.
  68.  
  69.  
  70. Configuration:
  71.  
  72.    Cookie_list.awebrx and Cookie_killer.awebrx can be run from AWeb's ARexx menu
  73.    "Start ARexx macro...", or can be configured for use through the AWeb GUI
  74.    settings.
  75.  
  76.    startup.awebrx is just a simple version of an AWeb startup script which runs
  77.    Cookie_killer.awebrx; if you want to use this, set it up as the Command under
  78.    Settings>Program settings...>Programs>Type="Script run at startup", or just
  79.    incorporate the relevant line in an existing AWeb startup script.
  80.  
  81.  
  82. Usage:
  83.  
  84.    env:AWeb3/cookies_keep ("keep file")
  85.  
  86.       This file lists the domain-and-name pairs of all cookies that you have
  87.       selected to keep, and domain-only details; also stored and maintained in
  88.       envarc: for permanence.
  89.  
  90.       The file is automatically created or updated by the Cookie_keep_filer.awebrx
  91.       program when called from the interactive cookie list created by
  92.       Cookie_list.awebrx. This "Usage" text is here for information only - you
  93.       should never have to create or update this file manually.
  94.  
  95.    Cookie_list.awebrx
  96.  
  97.       Use this from within AWeb, as described in "Configuration" above; it will
  98.       present an HTML page ("interactive cookie list") listing current cookies
  99.       in AWeb's cache (memory, not disk). 
  100.  
  101.    Interactive cookie list
  102.  
  103.       This is a dynamic HTML page listing all current cookies, with check buttons
  104.       to indicate whether they should be kept or not. Any cookies already listed
  105.       in the keep file will have their "keep" buttons checked automatically, and
  106.       the "Keep this cookie" text in bold - this should allow you to identify
  107.       which "keep" selections you have altered.
  108.  
  109.       Processing options at the bottom of the page can be selected to indicate how
  110.       the displayed list should be processed - the changes to the displayed list
  111.       can be saved back to the keep file, the non-marked cookies deleted, or no
  112.       processing at all. See the HTML page itself and associated text for
  113.       detailed instructions.
  114.  
  115.    Cookie_killer.awebrx
  116.  
  117.       This program can be invoked three ways - from an AWeb startup
  118.       script, as an AWeb Arexx macro, or from the interactive cookie list.
  119.  
  120.       AWeb startup : Incorporate a call to this program in your AWeb startup
  121.       script - see startup.awebrx in this package for an example. Do this to
  122.       automatically delete any cookies from a previous session each time you
  123.       start up AWeb; cookies in the keep file will not, of course, be deleted.
  124.  
  125.       AWeb ARexx macro : Do this if you just want to purge any cookies not
  126.       currently in the keep file without altering the keep file nor displaying
  127.       the current contents of the cookie cache.
  128.  
  129.       Interactive cookie list : Clicking the "Kill" process button invokes this
  130.       program to delete any cookies that have not been set to "keep" on the HTML
  131.       page.
  132.  
  133.       This program is intended to need arguments only when invoked from
  134.       the interactive cookie list; otherwise, it should be invoked without
  135.       arguments. If you want a requester to appear announcing completion of
  136.       processing, add the argument QUIET="N" to the invocaton of this program;
  137.       default value is QUIET="Y".
  138.  
  139.    startup.awebrx
  140.  
  141.       Shows how to invoke Cookie_killer.awebrx from within another ARexx
  142.       program. Use it as described in "Configuration" above; alternatively, if
  143.       you already have a startup script, copy the line from here that invokes
  144.       Cookie_killer.awebrx and paste into your own startup script.
  145.  
  146.    Cookie_keep_filer.awebrx
  147.  
  148.       This handles the process of re-writing the cookie keep file from the
  149.       selections made in the interactive cookie list. If the appropriate
  150.       process is selected on the interactive page, this program will pass
  151.       control to Cookie_killer.awebrx. It is not intended to be invoked manually.
  152.  
  153.    Cookie_file_cnvrt.awebrx
  154.  
  155.       This is a transparent process that handles upgrading of the cookie keep file;
  156.       currently, it reformats the file to bring it into line with the requirements
  157.       of v1.2. This is automatically called from Cookie_list.awebrx and
  158.       Cookie_killer.awebrx if they find that the file version is obsolete; it
  159.       should only be called the first time you run any Cookie_Killer process.
  160.  
  161.       If the file conversion process fails, the other Cookie_Killer processes
  162.       will not continue. I have made strenuous efforts to ensure that this is a
  163.       robust process; if you have problems, you can delete (or rename) your existing
  164.       cookie keep file. Contact me if you have insurmountable problems with
  165.       this conversion.
  166.  
  167. Note that, with the current implementation, there is an external limit on the
  168. number of cookies that can be specified for retention - about 120 as a minimum.
  169. If this is a problem for you, let me know.
  170.  
  171.  
  172. Change log (reverse chronology):
  173.  
  174. 1.21 (public) - Wednesday 07 March 2001
  175.  
  176.    Minor fix to use AWebPath: (assign dynamically added when AWeb
  177.    starts) rather than AWeb3: (assign which may or may not be set
  178.    by AWeb installation).
  179.  
  180. 1.2 (public) - Wednesday 21 February 2001
  181.  
  182.    Simpler and more efficient handling of "keep by domain".
  183.  
  184.    Interactive cookie list sorted by domain.
  185.  
  186.    If cookie keep file not found for interactive cookie list, add note at top of
  187.    list page rather than issuing a requester.
  188.  
  189.    Split cookie keep file management out of Cookie_killer.awebrx; now in
  190.    Cookie_keep_filer.awebrx.
  191.  
  192.    New program Cookie_file_cnvrt.awebrx to convert keep file to
  193.    format required for V1.2.
  194.  
  195. 1.1 (public) - Wednesday 17 January 2001
  196.  
  197.    Single process buttons on interactive cookie list page,
  198.    rather than select-and-process buttons.
  199.  
  200.    Separate explanatory usage page for interactive cookie list.
  201.  
  202.    Allow cookies to be kept by domain only.
  203.  
  204.    Added author contact mailto:
  205.  
  206.    Corrected minor omission in Cookie_killer.awebrx - explicitly close 4env
  207.    after use.
  208.  
  209. 1.01 (public) - Sunday 07 January 2001
  210.  
  211.    Enhanced argument processing - non-error requesters (e.g. "Processing
  212.    Completed") will not appear unless argument QUIET="N" is set. The
  213.    interactive cookie list sets this argument, but otherwise default
  214.    QUIET="Y" is used.
  215.  
  216.    Fixed bug in Cookie_list.awebrx when no cookies in memory.
  217.  
  218. 1.0 (public) - Friday 05 January 2001
  219.  
  220.    First public release.
  221.  
  222.  
  223. ============================= Archive contents =============================
  224.  
  225. Original  Packed Ratio    Date     Time    Name
  226. -------- ------- ----- --------- --------  -------------
  227.     2802    1844 34.1% 05-Jan-01 13:47:40  Cookie_Killer_pkg.info
  228.     2802    1844 34.1% 05-Jan-01 21:06:08 +Cookie_killer.info
  229.     9394    3715 60.4% 07-Mar-01 23:31:30 +Cookie_killer.readme
  230.     2686    1315 51.0% 05-Jan-01 21:02:14 +Cookie_killer.readme.info
  231.     8840    2877 67.4% 07-Mar-01 22:54:30 +Cookie_file_cnvrt.awebrx
  232.     8326    3180 61.8% 07-Mar-01 22:55:18 +Cookie_keep_filer.awebrx
  233.     9231    3402 63.1% 07-Mar-01 23:07:42 +Cookie_killer.awebrx
  234.    14613    4802 67.1% 07-Mar-01 22:54:46 +Cookie_list.awebrx
  235.     3876    1577 59.3% 21-Feb-01 13:18:26 +cookie_list_usage.html
  236.     1099     577 47.4% 21-Feb-01 14:21:44 +startup.awebrx
  237. -------- ------- ----- --------- --------
  238.    63669   25133 60.5% 08-Mar-101 21:44:38   10 files
  239.